.. _secdiGetMulti:

secdiGetMulti
================
----------------

SYNOPSYS
`````````````
.. code-block:: none

   t_dword secdiGetMulti(
       [in] t_i32 NetID, 
       [in] t_ui32 IniChannel, 
       [in] t_ui8 NumChannels, 
       [out] t_i32 *ErrCode
       )




DESCRIPTION
`````````````  

- 다수의 디지털 입력 채널의 상태를 확인합니다. 


PARAMETER
`````````````
- NetID  : 사용자가 사용 할 Network 번호

- IniChannel : 시작 **전역채널** 번호(0 base)

- NumChannels : IniChannel부터 선택되는 채널의 갯수 (최대 32)

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.


RETURN VALUE
`````````````

- 다중 채널의 디지털 입력 상태 값이 채널개수(NumChannels) 만큼 비트순서로 저장되어 반환 합니다.

+-----------------------------+-----+----------------------------+----------------------+
| 31번 비트                   | ... | 1번 비트                   | 0번 비트             |
+=============================+=====+============================+======================+
| (iniChannel+31)번 채널 상태 | ... | (iniChannel+1)번 채널 상태 | iniChannel 채널 상태 |
+-----------------------------+-----+----------------------------+----------------------+

Example
`````````````

.. code-block:: c++
 :linenos:

    #include "ComiSWECATSdk_Api.h"
    #define NUMCHNNELS 2 //사용자가 사용 할 채널 수를 입력

    void DI_GetMulit(void)
    {
        t_i32 NetID = 0; // Network ID
        t_i32 NetID = 0; // Network ID
        t_32 Error_Num = 0; //함수 별 에러 코드 저장 변수
        t_i16 DI_InitCh = 0; //시작 채널 번호 저장 변수
        t_dword State = 0; // DI_Multi 결과 값 저장 변수

        State = secdiGetMulti (NetID, DI_InitCh, NUMCHNNELS, &Error_Num);
        // State 에 결과 값에는 DI 결과 값이 비트순서대로 저장
        // ex)0 번 채널부터 1 번까지 모든 채널이 ON 이라면 결과값은 0x11 즉 10 진수 3
        
    } // DI_GetMulit 함수 종료


.. seealso:: :ref:`secdiGetOne`